139 lines
2.6 KiB
C
139 lines
2.6 KiB
C
|
/*++
|
|||
|
|
|||
|
Copyright (c) 1995-2001 Microsoft Corporation
|
|||
|
|
|||
|
Module Name:
|
|||
|
|
|||
|
rpcbind.c
|
|||
|
|
|||
|
Abstract:
|
|||
|
|
|||
|
This module contains the RPC bind and un-bind routines for the
|
|||
|
Configuration Manager client-side APIs.
|
|||
|
|
|||
|
Author:
|
|||
|
|
|||
|
Paula Tomlinson (paulat) 6-21-1995
|
|||
|
|
|||
|
Environment:
|
|||
|
|
|||
|
User-mode only.
|
|||
|
|
|||
|
Revision History:
|
|||
|
|
|||
|
21-June-1995 paulat
|
|||
|
|
|||
|
Creation and initial implementation.
|
|||
|
|
|||
|
--*/
|
|||
|
|
|||
|
|
|||
|
//
|
|||
|
// includes
|
|||
|
//
|
|||
|
#include "precomp.h"
|
|||
|
#include "cfgi.h"
|
|||
|
|
|||
|
|
|||
|
|
|||
|
handle_t
|
|||
|
PNP_HANDLE_bind (
|
|||
|
PNP_HANDLE ServerName
|
|||
|
)
|
|||
|
|
|||
|
/*++
|
|||
|
|
|||
|
Routine Description:
|
|||
|
|
|||
|
This routine calls a common bind routine that is shared by all
|
|||
|
services. This routine is called from the PNP API client stubs
|
|||
|
when it is necessary to bind to a server. The binding is done to
|
|||
|
allow impersonation by the server since that is necessary for the
|
|||
|
API calls.
|
|||
|
|
|||
|
Arguments:
|
|||
|
|
|||
|
ServerName - A pointer to a string containing the name of the server
|
|||
|
to bind with.
|
|||
|
|
|||
|
Return Value:
|
|||
|
|
|||
|
The binding handle is returned to the stub routine. If the
|
|||
|
binding is unsuccessful, a NULL will be returned.
|
|||
|
|
|||
|
--*/
|
|||
|
|
|||
|
{
|
|||
|
handle_t BindingHandle;
|
|||
|
RPC_STATUS Status;
|
|||
|
|
|||
|
|
|||
|
Status = RpcpBindRpc(
|
|||
|
ServerName, // UNC Server Name
|
|||
|
L"ntsvcs",
|
|||
|
L"Security=Impersonation Dynamic True",
|
|||
|
&BindingHandle);
|
|||
|
|
|||
|
//
|
|||
|
// the possible return codes from RpcpBindRpc are STATUS_SUCCESS,
|
|||
|
// STATUS_NO_MEMORY and STATUS_INVALID_COMPUTER_NAME. Since the format
|
|||
|
// of the bind routine is fixed, set any errors encountered as the last
|
|||
|
// error and return NULL.
|
|||
|
//
|
|||
|
if (Status != STATUS_SUCCESS) {
|
|||
|
|
|||
|
BindingHandle = NULL;
|
|||
|
|
|||
|
if (Status == STATUS_NO_MEMORY) {
|
|||
|
SetLastError(ERROR_NOT_ENOUGH_MEMORY);
|
|||
|
}
|
|||
|
else if (Status == STATUS_INVALID_COMPUTER_NAME) {
|
|||
|
SetLastError(ERROR_INVALID_COMPUTERNAME);
|
|||
|
}
|
|||
|
else SetLastError(ERROR_GEN_FAILURE);
|
|||
|
}
|
|||
|
|
|||
|
return BindingHandle;
|
|||
|
|
|||
|
} // PNP_HANDLE_bind
|
|||
|
|
|||
|
|
|||
|
|
|||
|
void
|
|||
|
PNP_HANDLE_unbind (
|
|||
|
PNP_HANDLE ServerName,
|
|||
|
handle_t BindingHandle
|
|||
|
)
|
|||
|
|
|||
|
/*++
|
|||
|
|
|||
|
Routine Description:
|
|||
|
|
|||
|
This routine calls a common unbind routine that is shared by
|
|||
|
all services. It is called from the Browser service client stubs
|
|||
|
when it is necessary to unbind from the server end.
|
|||
|
|
|||
|
Arguments:
|
|||
|
|
|||
|
ServerName - This is the name of the server from which to unbind.
|
|||
|
|
|||
|
BindingHandle - This is the binding handle that is to be closed.
|
|||
|
|
|||
|
Return Value:
|
|||
|
|
|||
|
none.
|
|||
|
|
|||
|
--*/
|
|||
|
{
|
|||
|
RPC_STATUS status;
|
|||
|
|
|||
|
UNREFERENCED_PARAMETER(ServerName);
|
|||
|
|
|||
|
status = RpcpUnbindRpc(BindingHandle);
|
|||
|
|
|||
|
return;
|
|||
|
|
|||
|
} // PNP_HANDLE_unbind
|
|||
|
|
|||
|
|