Função DsGetDcSiteCoverageA (dsgetdc.h)

Artigo
11/20/2024

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 ULONG valor 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.

Valor de retorno

Essa função retorna DWORD DSGETDCAPI.

Observações

Nota

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

DsGetSiteName

NetApiBufferFree

Compartilhar via