Edit

Share via

RpcProtseqVectorFreeA function (rpcdce.h)

  • Article

The RpcProtseqVectorFree function frees the protocol sequences contained in the vector and the vector itself.

Syntax

RPC_STATUS RpcProtseqVectorFreeA(
  RPC_PROTSEQ_VECTORA **ProtseqVector
);

Parameters

ProtseqVector

Pointer to a pointer to a vector of protocol sequences. On return, the pointer is set to NULL.

Return value

Value Meaning
RPC_S_OK
 The call succeeded.
 
Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

A server calls RpcProtseqVectorFree to release the memory used to store a vector of protocol sequences and the individual protocol sequences. RpcProtseqVectorFree sets the ProtSeqVector parameter to a null value.

For a list of Microsoft RPC supported protocol sequences, see String Binding.

A server obtains a vector of protocol sequences by calling RpcNetworkInqProtseqs.

Note  RpcProtseqVectorFree is available for server and client applications using Microsoft RPC, but is more common and convenient for server applications.
 

Note

The rpcdce.h header defines RpcProtseqVectorFree as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

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 rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

See also

RpcNetworkInqProtseqs