Fonction ADsPropGetInitInfo (adsprop.h)

  • Article

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

Voir aussi

ADSPROPINITPARAMS

ADsPropCreateNotifyObj