139 lines
2.7 KiB
C
139 lines
2.7 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
|
||
|
||
|