Fonction ADsPropCreateNotifyObj (adsprop.h)

Article
02/23/2024

La fonction ADsPropCreateNotifyObj permet de créer ou d’obtenir un objet de notification à utiliser par une extension de feuille de propriétés services de domaine Active Directory.

Syntaxe

HRESULT ADsPropCreateNotifyObj(
  [in]  LPDATAOBJECT pAppThdDataObj,
  [in]  PWSTR        pwzADsObjName,
  [out] HWND         *phNotifyObj
);

Paramètres

[in] pAppThdDataObj

Pointeur vers l’objet IDataObject qui représente l’objet directory auquel la page de propriétés s’applique. Il s’agit de l’IDataObject passé à la méthode IShellExtInit ::Initialize de la page de propriétés.

[in] pwzADsObjName

Le nom de l’objet services de domaine Active Directory obtenu en appelant la méthode IDataObject ::GetData pour le format CFSTR_DSOBJECTNAMES presse-papiers sur l’objet IDataObject représenté par pAppThdDataObj.

[out] phNotifyObj

Pointeur vers une valeur HWND qui reçoit le handle de l’objet de notification.

Valeur retournée

Retourne S_OK en cas de réussite, ou une valeur d’erreur définie par OLE dans le cas contraire.

Remarques

La fonction ADsPropCreateNotifyObj est utilisée dans l’implémentation d’une extension de feuille de propriétés services de domaine Active Directory. L’extension doit d’abord demander les données CFSTR_DSOBJECTNAMES de l’interface IDataObject passées à IShellExtInit ::Initialize en appelant IDataObject ::GetData. Cela fournit l’objet de données et le nom d’objet requis pour appeler ADsPropCreateNotifyObj.

Lorsque l’objet de notification n’est plus nécessaire, un message WM_ADSPROP_NOTIFY_EXIT est envoyé à l’objet de notification. Cela entraîne la destruction de l’objet de notification. Lorsque le message WM_ADSPROP_NOTIFY_EXIT est envoyé, le handle de l’objet de notification doit être considéré comme non valide.

Exemples

L’exemple C++ suivant montre comment utiliser la fonction ADsPropCreateNotifyObj .

HWND CreateADsNotificationObject(IDataObject *pDataObject)
{
    STGMEDIUM   stm;
    FORMATETC   fe;
    HRESULT     hr;
    HWND        hwndNotifyObject = NULL;

    if(NULL == pDataObject)
    {
        return NULL;
    }

    fe.cfFormat = RegisterClipboardFormat(CFSTR_DSOBJECTNAMES);
    if(0 == fe.cfFormat)
    {
        return NULL;
    }
    fe.ptd = NULL;
    fe.dwAspect = DVASPECT_CONTENT;
    fe.lindex = -1;
    fe.tymed = TYMED_HGLOBAL;
    hr = pDataObject->GetData(&fe, &stm);
    if(SUCCEEDED(hr))
    {
        LPDSOBJECTNAMES pdson = 
            (LPDSOBJECTNAMES)GlobalLock(stm.hGlobal);

        if(pdson)
        {
            LPWSTR  pwszName = (LPWSTR)((LPBYTE)pdson + 
                pdson->aObjects[0].offsetName);
            
            hr = ADsPropCreateNotifyObj(pDataObject, 
                pwszName, 
                &hwndNotifyObject);
    
            GlobalUnlock(stm.hGlobal);    
        }
        
        ReleaseStgMedium(&stm);
    }

    return hwndNotifyObject;
}

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