ADsPropGetInitInfo 함수(adsprop.h)

ADsPropGetInitInfo 함수는 Active Directory Domain Services 속성 시트 확장이 적용되는 디렉터리 개체 데이터를 가져오는 데 사용됩니다.

구문

BOOL ADsPropGetInitInfo(
  [in]  HWND               hNotifyObj,
  [out] PADSPROPINITPARAMS pInitParams
);

매개 변수

[in] hNotifyObj

알림 개체의 핸들입니다. 이 핸들을 가져오려면 ADsPropCreateNotifyObj를 호출합니다.

[out] pInitParams

디렉터리 개체 데이터를 수신하는 ADSPROPINITPARAMS 구조체에 대한 포인터입니다. 이 함수를 호출하기 전에 이 구조체의 dwSize 멤버를 입력해야 합니다.

반환 값

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.

설명

pwzCN 및 pWritableAttrs 멤버에 대한 메모리는 ADsPropGetInitInfo 함수에 의해 할당됩니다. 이 메모리는 모든 속성 시트 개체가 제거된 후 시스템에서 해제됩니다. pDsObj의 인터페이스 포인터에 대한 참조 수는 ADsPropGetInitInfo를 호출하여 증가하지 않으므로 호출자가 인터페이스를 해제해서는 안 됩니다.

다중 선택 속성 시트의 경우 시스템은 DSOBJECT 배열의 첫 번째 개체에만 바인딩됩니다. 이 때문에 ADsPropGetInitInfo 는 배열의 첫 번째 개체에 대한 IDirectoryObject 및 쓰기 가능한 특성만 제공합니다. 배열의 다른 개체는 바인딩되지 않습니다.

예제

다음 코드 예제에서는 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;
}

요구 사항

추가 정보

ADSPROPINITPARAMS

ADsPropCreateNotifyObj