Fonction ADsPropGetInitInfo (adsprop.h)
La fonction ADsPropGetInitInfo est utilisée pour obtenir des données d’objet d’annuaire auxquelles s’applique une extension de feuille de propriétés services de domaine Active Directory.
Syntaxe
BOOL ADsPropGetInitInfo(
[in] HWND hNotifyObj,
[out] PADSPROPINITPARAMS pInitParams
);
Paramètres
[in] hNotifyObj
Handle de l’objet de notification. Pour obtenir ce handle, appelez ADsPropCreateNotifyObj.
[out] pInitParams
Pointeur vers une structure ADSPROPINITPARAMS qui reçoit les données de l’objet d’annuaire. Le membre dwSize de cette structure doit être entré avant d’appeler cette fonction.
Valeur retournée
Retourne une valeur différente de zéro en cas de réussite ou de zéro dans le cas contraire.
Remarques
La mémoire des membres pwzCN et pWritableAttrs est allouée par la fonction ADsPropGetInitInfo . Cette mémoire est libérée par le système après la destruction de tous les objets de feuille de propriétés. Le nombre de références pour le pointeur d’interface dans pDsObj n’est pas incrémenté en appelant ADsPropGetInitInfo. L’interface ne doit donc pas être libérée par l’appelant.
Pour les feuilles de propriétés à sélection multiple, le système est lié uniquement au premier objet du tableau DSOBJECT . Pour cette raison, ADsPropGetInitInfo fournit uniquement les attributs IDirectoryObject et accessible en écriture pour le premier objet du tableau. Les autres objets du tableau ne sont pas liés à.
Exemples
L’exemple de code suivant montre comment utiliser la fonction 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;
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | adsprop.h |
| Bibliothèque | Dsprop.lib |
| DLL | Dsprop.dll |