3.1.4.2 NspiUnbind (Opnum 1)

  • Article

The NspiUnbind method destroys the context handle. No other action is taken.

 DWORD NspiUnbind(
   [in, out] NSPI_HANDLE* contextHandle,
   [in] DWORD Reserved
 );

contextHandle: An RPC context handle as specified in section 2.3.9.

Reserved: A DWORD value reserved for future use. MUST be ignored by the server.

Return Values: The server returns a DWORD value specifying the return status of the method.

Exceptions Thrown

No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE].

Server Processing Rules

Upon receiving this message, the server MUST process the data from the message subject to the following constraints:

  1. If the input parameter contextHandle is NULL, the server MUST return the value 2.

  2. If the server successfully destroys the context handle, the server MUST return the value 1.

  3. If no other return code has been set, the server MUST return the value 2.

  4. The server MUST set the output parameter contextHandle to NULL.