RpcNsProfileEltInqDone function (rpcnsi.h)

Article
02/22/2024

The RpcNsProfileEltInqDone function deletes the inquiry context for viewing the elements in a profile.

Note This function is not supported on Windows Vista and later operating systems.

Syntax

RPC_STATUS RpcNsProfileEltInqDone(
  RPC_NS_HANDLE *InquiryContext
);

Parameters

InquiryContext

Pointer to a name-service handle to free. The name-service handle that InquiryContext points to is created by calling the RpcNsProfileEltInqBegin function.

An argument value of NULL is returned.

Return value

Value	Meaning
RPC_S_OK	The call succeeded.

Note For a list of valid error codes, see RPC Return Values.

Remarks

The RpcNsProfileEltInqDone function frees an inquiry context created by calling RpcNsProfileEltInqBegin.

An application calls RpcNsProfileEltInqDone after viewing profile elements using the RpcNsProfileEltInqNext function.

Note Windows 2000 Active Directory supports this function. Earlier versions of Windows NT support the use of this function with Cell Directory Service (CDS) only.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	rpcnsi.h (include Rpc.h)
Library	Rpcns4.lib
DLL	Rpcns4.dll