Função RpcProtseqVectorFreeA (rpcdce.h)

A função RpcProtseqVectorFree libera as sequências de protocolo contidas no vetor e no próprio vetor.

Sintaxe

RPC_STATUS RpcProtseqVectorFreeA(
  RPC_PROTSEQ_VECTORA **ProtseqVector
);

Parâmetros

ProtseqVector

Ponteiro para um ponteiro para um vetor de sequências de protocolo. No retorno, o ponteiro é definido como NULL.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.

 

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

 

Observações

Um servidor chama RpcProtseqVectorFree para liberar a memória usada para armazenar um vetor de sequências de protocolo e as sequências de protocolo individuais. RpcProtseqVectorFree define o parâmetro ProtSeqVector como um valor nulo.

Para obter uma lista de sequências de protocolo compatíveis com o Microsoft RPC, consulte String Binding.

Um servidor obtém um vetor de sequências de protocolo chamando RpcNetworkInqProtseqs.

Observação RpcProtseqVectorFree está disponível para aplicativos cliente e servidor usando o Microsoft RPC, mas é mais comum e conveniente para aplicativos de servidor.

 

Nota

O cabeçalho rpcdce.h define RpcProtseqVectorFree 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 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcNetworkInqProtseqs