RpcNsBindingUnexportPnP function
The RpcNsBindingUnexportPnP function removes the binding handles for Plug and Play interfaces and objects from an entry in the name-service database.
Syntax
RPC_STATUS RPC_ENTRY RpcNsBindingUnexportPnP( unsigned long EntryNameSyntax, unsigned char *EntryName, RPC_IF_HANDLE IfSpec, UUID_VECTOR *ObjectUuidVec );
Parameters
- EntryNameSyntax
-
Syntax of EntryName.
To use the syntax specified in the registry value entry HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
- EntryName
-
Pointer to the entry name from which to remove binding handles and object UUIDs.
- IfSpec
-
Interface specification for the binding handles to be removed from the name service database. A null parameter value indicates not to unexport any binding handles (only object UUIDs are to be unexported).
- ObjectUuidVec
-
Pointer to a vector of object UUIDs that the server no longer wants to offer. The application constructs this vector. A null value indicates there are no object UUIDs to unexport (only binding handles are to be unexported).
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The version option is invalid. |
|
The name syntax is invalid. |
|
The name syntax is unsupported. |
|
The name is incomplete. |
|
The name-service entry was not found. |
|
The name service is unavailable. |
|
The interface was not found. |
|
Not all objects unexported. |
Remarks
The RpcNsBindingUnexportPnP function allows a server application to remove the binding handles and object UUIDs of Plug and Play-compatible resources from a name service database entry. A server application can unexport the specified interface and objects in a single call to RpcNsBindingUnexportPnP, or it can unexport them separately. Only the binding handles that match the interface UUID and the major and minor interface version numbers found in the IfSpec parameter are unexported.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
RpcNsBindingUnexportPnPW (Unicode) and RpcNsBindingUnexportPnPA (ANSI) |
See also