Função DsGetDcSiteCoverageA (dsgetdc.h)

A função DsGetDcSiteCoverage retorna os nomes de site de todos os sites cobertos por um controlador de domínio.

Sintaxe

DSGETDCAPI DWORD DsGetDcSiteCoverageA(
  [in, optional] LPCSTR ServerName,
  [out]          PULONG EntryCount,
  [out]          LPSTR  **SiteNames
);

Parâmetros

[in, optional] ServerName

O valor da cadeia de caracteres terminada em nulo que especifica o nome do controlador de domínio remoto.

[out] EntryCount

Ponteiro para um valor ULONG que recebe o número de sites cobertos pelo controlador de domínio.

[out] SiteNames

Ponteiro para uma matriz de ponteiros para cadeias de caracteres terminadas em nulo que recebe os nomes do site. Para liberar o buffer retornado, chame a função NetApiBufferFree .

Retornar valor

Essa função retorna DWORD DSGETDCAPI.

Comentários

Observação

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

Requisito	Valor
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

DsGetSiteName

NetApiBufferFree