Share via

Função DsAddressToSiteNamesA (dsgetdc.h)

  • Artigo

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 terminadas 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 será 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 adequado. O chamador deve liberar essa matriz quando ela não for mais necessária chamando NetApiBufferFree.

Valor retornado

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

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho dsgetdc.h
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

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

DsAddressToSiteNamesEx

Dsgetdcname

NetApiBufferFree