Função RpcNetworkIsProtseqValidA (rpcdce.h)

A função RpcNetworkIsProtseqValid informa se a sequência de protocolo especificada tem suporte tanto pela biblioteca de tempo de execução do RPC quanto pelo sistema operacional. Os aplicativos de servidor geralmente usam RpcNetworkInqProtseqs.

Sintaxe

RPC_STATUS RpcNetworkIsProtseqValidA(
  RPC_CSTR Protseq
);

Parâmetros

Protseq

Ponteiro para um identificador de cadeia de caracteres da sequência de protocolo a ser verificada.

Se o parâmetro Protseq não for uma cadeia de caracteres de sequência de protocolo válida, RpcNetworkIsProtseqValid retornará RPC_S_INVALID_RPC_PROTSEQ.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.; sequência de protocolos com suporte
RPC_S_PROTSEQ_NOT_SUPPORTED	Não há suporte para a sequência de protocolos neste host.
RPC_S_INVALID_RPC_PROTSEQ	Sequência de protocolo inválida.

 

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

 

Observações

Um aplicativo chama a função RpcNetworkIsProtseqValid para determinar se uma sequência de protocolo individual está disponível para fazer chamadas de procedimento remoto.

Uma sequência de protocolo é válida se a biblioteca de tempo de execução do RPC e o sistema operacional dão suporte aos protocolos especificados. Para obter uma lista das sequências de protocolo com suporte do Microsoft RPC, consulte String Binding. Um aplicativo chama RpcNetworkInqProtseqs para ver todas as sequências de protocolo com suporte.

Nota

O cabeçalho rpcdce.h define RpcNetworkIsProtseqValid como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcNetworkInqProtseqs