Método IDsDisplaySpecifier::GetDisplaySpecifier (dsclient.h)
O método IDsDisplaySpecifier::GetDisplaySpecifier é associado ao objeto especificador de exibição para uma determinada classe em Active Directory Domain Services.
Sintaxe
HRESULT GetDisplaySpecifier(
[in] LPCWSTR pszObjectClass,
[in] REFIID riid,
[in, out] void **ppv
);
Parâmetros
[in] pszObjectClass
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da classe de objeto para a qual recuperar o especificador de exibição.
[in] riid
Contém o identificador de interface da interface desejada.
[in, out] ppv
Ponteiro para um ponteiro de interface que recebe o especificador de exibição da classe de objeto.
Retornar valor
Retorna um valor HRESULT padrão, incluindo o seguinte.
Comentários
Esse método usa a função ADsOpenObject para associar ao objeto especificador de exibição da classe fornecida. Se isso falhar, ele tentará associar ao especificador de exibição na localidade do usuário. Se isso falhar novamente, ele será associado ao especificador de exibição na localidade padrão.
Esse método usa as credenciais do servidor e do usuário definidas por uma chamada anterior para IDsDisplaySpecifier::SetServer.
Exemplos
O exemplo de código a seguir demonstra como chamar esse método.
HRESULT hr;
IDsDisplaySpecifier *pDS;
hr = CoCreateInstance(CLSID_DsDisplaySpecifier,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDsDisplaySpecifier,
(void**)&pDS);
if(SUCCEEDED(hr))
{
IADs *pads;
hr = pDS->GetDisplaySpecifier(L"user", IID_IADs, (LPVOID*)&pads);
if(SUCCEEDED(hr))
{
pads->Release();
}
pDS->Release();
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | dsclient.h |
| DLL | Dsadmin.dll |