Função DsAddressToSiteNamesA (dsgetdc.h)

Artigo
11/20/2024

A função DsAddressToSiteNames obtém os nomes de site correspondentes aos endereços especificados.

Sintaxe

DSGETDCAPI DWORD DsAddressToSiteNamesA(
  [in, optional] LPCSTR          ComputerName,
  [in]           DWORD           EntryCount,
  [in]           PSOCKET_ADDRESS SocketAddresses,
  [out]          LPSTR           **SiteNames
);

Parâmetros

[in, optional] ComputerName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do servidor remoto para processar essa função. Esse parâmetro deve ser o nome de um controlador de domínio. Um controlador que não seja de domínio pode chamar essa função chamando DsGetDcName para localizar o controlador de domínio.

[in] EntryCount

Contém o número de elementos na matriz socketAddresses .

[in] SocketAddresses

Contém uma matriz de estruturas SOCKET_ADDRESS que contêm os endereços a serem convertidos. Cada endereço nessa matriz deve ser do tipo AF_INET. EntryCount contém o número de elementos nessa matriz.

[out] SiteNames

Recebe uma matriz de ponteiros de cadeia de caracteres encerrados em nulo que contêm os nomes de site para os endereços. Cada elemento nessa matriz corresponde ao mesmo elemento na matriz SocketAddresses. Um elemento é NULL se o endereço correspondente não for mapeado para nenhum site conhecido ou se a entrada de endereço não for do formulário apropriado. O chamador deve liberar essa matriz quando ela não for mais necessária chamando NetApiBufferFree.

Valor de retorno

Retorna NO_ERROR se tiver êxito ou um erro Win32 ou RPC caso contrário. A lista a seguir lista possíveis códigos de erro.

Observações

Nota

O cabeçalho dsgetdc.h define DsAddressToSiteNames 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 Vista
servidor com suporte mínimo	Windows Server 2008
da Plataforma de Destino	Windows
cabeçalho	dsgetdc.h
biblioteca	Netapi32.lib
de DLL	Netapi32.dll

Consulte também

Funções de serviço de diretório

DsAddressToSiteNamesEx

DsGetDcName

NetApiBufferFree

Compartilhar via