Função RpcNsMgmtEntryInqIfIdsA (rpcnsi.h)

Artigo
11/20/2024

A função RpcNsMgmtEntryInqIfIds retorna a lista de interfaces exportadas para um serviço de nome– entrada de banco de dados. Ele também retorna um vetor de identificação de interface que contém as interfaces dos identificadores de associação exportados por um servidor para EntryName. Essa função usa uma idade de expiração de 0, causando uma atualização imediata da cópia local dos dados do serviço de nome.

Observação Essa função não tem suporte no Windows Vista e em sistemas operacionais posteriores.

Sintaxe

RPC_STATUS RpcNsMgmtEntryInqIfIdsA(
  unsigned long    EntryNameSyntax,
  RPC_CSTR         EntryName,
  RPC_IF_ID_VECTOR **IfIdVec
);

Parâmetros

EntryNameSyntax

Sintaxe de EntryName.

Para usar a sintaxe especificada na entrada de valor do Registro HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, forneça um valor de RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Ponteiro para o nome do serviço – nome de entrada do banco de dados para o qual um vetor de identificação de interface é retornado.

IfIdVec

Retorna um endereço de um ponteiro para o vetor de identificação de interface.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_NAME_SYNTAX	A sintaxe de nome é inválida.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Não há suporte para a sintaxe de nome.
RPC_S_INCOMPLETE_NAME	O nome está incompleto.
RPC_S_ENTRY_NOT_FOUND	A entrada nome-serviço não foi encontrada.
RPC_S_NAME_SERVICE_UNAVAILABLE	O serviço de nome não está disponível.

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

Observações

A função RpcNsMgmtEntryInqIfIds retorna um vetor de identificação de interface que contém as interfaces de identificadores de associação exportadas por um servidor para EntryName. Essa função usa uma idade de expiração de 0, causando uma atualização imediata da cópia local dos dados do serviço de nome. O aplicativo de chamada é responsável por chamar a função RpcIfIdVectorFree para liberar a memória usada pelo vetor.

Nota

O cabeçalho rpcnsi.h define RpcNsMgmtEntryInqIfIds 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	rpcnsi.h (inclua Rpc.h)
biblioteca	Rpcns4.lib
de DLL	Rpcns4.dll

Consulte também

RpcIfIdVectorFree

RpcIfInqId

RpcNsBindingExport

Compartilhar via