Função DsAddressToSiteNamesExA (dsgetdc.h)

Artigo
11/20/2024

A função DsAddressToSiteNamesEx obtém os nomes de site e sub-rede correspondentes aos endereços especificados.

Sintaxe

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

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.

[out] SubnetNames

Recebe uma matriz de ponteiros de cadeia de caracteres encerrados em nulo que contêm os nomes de sub-rede usados para executar o endereço para mapeamentos de nome do site. Cada elemento nessa matriz corresponde ao mesmo elemento na matriz SocketAddresses. Um elemento é nulo se o endereço correspondente ao mapeamento de nome do site não foi determinado ou se nenhuma sub-rede foi usada para executar o endereço correspondente ao mapeamento do site. Este último será o caso quando houver exatamente um site na empresa sem objetos de sub-rede mapeados para ele. 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 seguir estão possíveis códigos de erro.

Observações

Nota

O cabeçalho dsgetdc.h define DsAddressToSiteNamesEx 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

DsAddressToSiteNames

DsGetDcName

NetApiBufferFree

Compartilhar via