Função ADsPropGetInitInfo (adsprop.h)
A função ADsPropGetInitInfo é usada para obter dados de objeto de diretório aos quais uma extensão de folha de propriedades Active Directory Domain Services se aplica.
Sintaxe
BOOL ADsPropGetInitInfo(
[in] HWND hNotifyObj,
[out] PADSPROPINITPARAMS pInitParams
);
Parâmetros
[in] hNotifyObj
O identificador do objeto de notificação. Para obter esse identificador, chame ADsPropCreateNotifyObj.
[out] pInitParams
Ponteiro para uma estrutura ADSPROPINITPARAMS que recebe os dados do objeto de diretório. O membro dwSize dessa estrutura deve ser inserido antes de chamar essa função.
Retornar valor
Retornará diferente de zero se tiver êxito ou zero caso contrário.
Comentários
A memória para os membros pwzCN e pWritableAttrs é alocada pela função ADsPropGetInitInfo . Essa memória é liberada pelo sistema depois que todos os objetos da folha de propriedades são destruídos. A contagem de referência para o ponteiro de interface em pDsObj não é incrementada chamando ADsPropGetInitInfo, portanto, a interface não deve ser liberada pelo chamador.
Para folhas de propriedades de seleção múltipla, o sistema só se associa ao primeiro objeto na matriz DSOBJECT . Por isso, ADsPropGetInitInfo fornece apenas os atributos IDirectoryObject e graváveis para o primeiro objeto na matriz. Os outros objetos na matriz não estão associados.
Exemplos
O exemplo de código a seguir mostra como usar a função ADsPropGetInitInfo .
HRESULT GetADsPageInfo(HWND hwndNotifyObject, ADSPROPINITPARAMS *pip)
{
if((NULL == pip) || (!IsWindow(hwndNotifyObject)))
{
return E_INVALIDARG;
}
ADSPROPINITPARAMS InitParams;
InitParams.dwSize = sizeof(ADSPROPINITPARAMS);
if(ADsPropGetInitInfo(hwndNotifyObject, &InitParams))
{
*pip = InitParams;
return InitParams.hr;
}
return E_FAIL;
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | adsprop.h |
| Biblioteca | Dsprop.lib |
| DLL | Dsprop.dll |