Edit

Share via

RpcNetworkIsProtseqValid function (rpcdce.h)

  • Article

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

Requirement Value
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