Función ADsPropGetInitInfo (adsprop.h)
La función ADsPropGetInitInfo se usa para obtener datos de objeto de directorio a los que se aplica una extensión de hoja de propiedades Servicios de dominio de Active Directory.
Sintaxis
BOOL ADsPropGetInitInfo(
[in] HWND hNotifyObj,
[out] PADSPROPINITPARAMS pInitParams
);
Parámetros
[in] hNotifyObj
Identificador del objeto de notificación. Para obtener este identificador, llame a ADsPropCreateNotifyObj.
[out] pInitParams
Puntero a una estructura ADSPROPINITPARAMS que recibe los datos del objeto de directorio. El miembro dwSize de esta estructura debe escribirse antes de llamar a esta función.
Valor devuelto
Devuelve un valor distinto de cero si es correcto o cero de lo contrario.
Comentarios
La función ADsPropGetInitInfo asigna la memoria para los miembros pwzCN y pWritableAttrs. El sistema libera esta memoria después de destruir todos los objetos de hoja de propiedades. El recuento de referencias para el puntero de interfaz en pDsObj no se incrementa llamando a ADsPropGetInitInfo, por lo que el autor de la llamada no debe liberar la interfaz.
En el caso de las hojas de propiedades de selección múltiple, el sistema solo se enlaza al primer objeto de la matriz DSOBJECT . Por este motivo, ADsPropGetInitInfo solo proporciona los atributos IDirectoryObject y grabables para el primer objeto de la matriz. Los demás objetos de la matriz no están enlazados.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la función 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | adsprop.h |
| Library | Dsprop.lib |
| Archivo DLL | Dsprop.dll |