Funzione ADsPropGetInitInfo (adsprop.h)
La funzione ADsPropGetInitInfo viene utilizzata per ottenere i dati dell'oggetto directory a cui si applica un'estensione della finestra delle proprietà Active Directory Domain Services.
Sintassi
BOOL ADsPropGetInitInfo(
[in] HWND hNotifyObj,
[out] PADSPROPINITPARAMS pInitParams
);
Parametri
[in] hNotifyObj
Handle dell'oggetto notifica. Per ottenere questo handle, chiamare ADsPropCreateNotifyObj.
[out] pInitParams
Puntatore a una struttura ADSPROPINITPARAMS che riceve i dati dell'oggetto directory. Il membro dwSize di questa struttura deve essere immesso prima di chiamare questa funzione.
Valore restituito
Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.
Commenti
La memoria per i membri pwzCN e pWritableAttrs viene allocata dalla funzione ADsPropGetInitInfo . Questa memoria viene liberata dal sistema dopo che tutti gli oggetti della finestra delle proprietà vengono eliminati definitivamente. Il conteggio dei riferimenti per il puntatore di interfaccia in pDsObj non viene incrementato chiamando ADsPropGetInitInfo, quindi l'interfaccia non deve essere rilasciata dal chiamante.
Per le finestre delle proprietà a selezione multipla, il sistema viene associato solo al primo oggetto nella matrice DSOBJECT . Per questo motivo, ADsPropGetInitInfo fornisce solo gli attributi IDirectoryObject e scrivibili per il primo oggetto nella matrice. Gli altri oggetti nella matrice non sono associati.
Esempio
Nell'esempio di codice seguente viene illustrato come usare la funzione 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;
}
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | adsprop.h |
| Libreria | Dsprop.lib |
| DLL | Dsprop.dll |