RpcNetworkIsProtseqValidW 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 RpcNetworkIsProtseqValidW(
RPC_WSTR 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 |
---|---|
|
The call succeeded.; protocol sequence supported |
|
Protocol sequence not supported on this host. |
|
Invalid protocol sequence. |
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.
Note
The rpcdce.h header defines RpcNetworkIsProtseqValid 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 | 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 |