RpcNetworkIsProtseqValid function (rpcdce.h)

The RpcNetworkIsProtseqValid function tells whether the specified protocol sequence is supported by both the RPC run-time library and the operating system. Server applications often use RpcNetworkInqProtseqs.

Syntax

RPC_STATUS RpcNetworkIsProtseqValid(
  RPC_CSTR Protseq
);

Parameters

Protseq

Pointer to a string identifier of the protocol sequence to be checked.

If the Protseq parameter is not a valid protocol sequence string, RpcNetworkIsProtseqValid returns RPC_S_INVALID_RPC_PROTSEQ.

Return value

Value Meaning
RPC_S_OK
The call succeeded.; protocol sequence supported
RPC_S_PROTSEQ_NOT_SUPPORTED
Protocol sequence not supported on this host.
RPC_S_INVALID_RPC_PROTSEQ
Invalid protocol sequence.
 
Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

An application calls the RpcNetworkIsProtseqValid function to determine whether an individual protocol sequence is available for making remote procedure calls.

A protocol sequence is valid if both the RPC run-time library and the operating system support the specified protocols. For a list of Microsoft RPC's supported protocol sequences, see String Binding. An application calls RpcNetworkInqProtseqs to see all of the supported protocol sequences.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

See also

RpcNetworkInqProtseqs