Edit

Share via

RpcNetworkInqProtseqsA function (rpcdce.h)

  • Article

The RpcNetworkInqProtseqs function returns all protocol sequences supported by both the RPC run-time library and the operating system. Client applications often use RpcNetworkIsProtseqValid. For a list of Microsoft RPC's supported protocol sequences, see String Binding.

Syntax

RPC_STATUS RpcNetworkInqProtseqsA(
  RPC_PROTSEQ_VECTORA **ProtseqVector
);

Parameters

ProtseqVector

Returns a pointer to a pointer to a protocol sequence vector.

Return value

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

Remarks

A server application calls the RpcNetworkInqProtseqs function to obtain a vector containing the protocol sequences supported by both the RPC run-time library and the operating system. If there are no supported protocol sequences, this function returns the RPC_S_NO_PROTSEQS status code and a ProtSeqVector parameter value of NULL.

The server is responsible for calling the RpcProtseqVectorFree function to release the memory used by the vector.

Note

The rpcdce.h header defines RpcNetworkInqProtseqs as an alias which 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 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

RpcNetworkIsProtseqValid