DSDISPLAYSPECOPTIONS 구조체(dsclient.h)
DSDISPLAYSPECOPTIONS 구조체는 CFSTR_DS_DISPLAY_SPEC_OPTIONS 클립보드 형식으로 반환되며 사용되는 표시 지정자에 대한 상황에 맞는 메뉴 또는 속성 페이지 확장에 데이터를 제공하는 데 사용됩니다. 확장에 필요한 자격 증명을 지정하고 Active Directory 서버의 데이터에 액세스하는 것이 중요합니다.
구문
typedef struct _DSDISPLAYSPECOPTIONS {
DWORD dwSize;
DWORD dwFlags;
DWORD offsetAttribPrefix;
DWORD offsetUserName;
DWORD offsetPassword;
DWORD offsetServer;
DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;
멤버
dwSize
버전 관리를 위한 구조체의 크기입니다.
dwFlags
개체에 대한 데이터를 나타내고 구조체의 내용을 정의하는 플래그 집합입니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.
DSDSOF_HASUSERANDSERVERINFO(0x00000001)
offsetUserName, offsetPassword, offsetServer 및 offsetServerConfigPath 멤버가 유효합니다.
DSDSOF_SIMPLEAUTHENTICATE(0x00000002)
ADsOpenObject를 호출할 때 ADS_SECURE_AUTHENTICATION 플래그를 지정하지 마세요.
DSDSOF_DONTSIGNSEAL(0x00000004)
디렉터리 서비스 개체를 열 때는 서명하고 봉인하지 마세요.
DSDSOF_DSAVAILABLE(0x40000000)
클라이언트가 Active Directory Domain Services 제어하는 도메인에 속한다고 가정하면 클라이언트가 사용자가 인증되었는지, 네트워크가 있는지 또는 로그인되었는지 확인하지 않도록 합니다.
offsetAttribPrefix
DSDISPLAYSPECOPTIONS 구조체의 시작부터 생성된 확장이 가져온 표시 지정자의 접두사를 포함하는 NULL로 끝나는 유니코드 문자열까지의 오프셋(바이트)을 포함합니다. 이 문자열은 다음 값 중 하나일 수 있습니다.
"admin"
확장은 adminPropertyPages 특성에서 가져옵니다.
"shell"
확장은 shellPropertyPages 특성에서 가져옵니다.
다음 예제에서는 이 멤버를 사용하는 방법을 보여줍니다.
pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos +
pdso->offsetAttribPrefix);
offsetUserName
DSDISPLAYSPECOPTIONS 구조체의 시작부터 바인딩을 인증하는 데 사용되는 사용자의 이름을 포함하는 NULL로 끝나는 유니코드 문자열까지의 오프셋(바이트)을 포함합니다. 이 멤버는 dwFlags 에 DSDSOF_HASUSERANDSERVERINFO 플래그가 포함된 경우에만 유효합니다. 이 멤버에 0이 포함된 경우 사용자 이름은 포함되지 않습니다.
다음 예제에서는 이 멤버를 사용하는 방법을 보여줍니다.
pwszUserName = (LPWSTR)((LPBYTE)pdso +
pdso->offsetUserName);
offsetPassword
DSDISPLAYSPECOPTIONS 구조체의 시작부터 바인딩을 인증하는 데 사용되는 암호를 포함하는 NULL로 끝나는 유니코드 문자열까지 오프셋(바이트)을 포함합니다. 이 멤버는 dwFlags 에 DSDSOF_HASUSERANDSERVERINFO 플래그가 포함된 경우에만 유효합니다. 이 멤버에 0이 포함된 경우 암호는 포함되지 않습니다.
다음 예제에서는 이 멤버를 사용하는 방법을 보여줍니다.
pwszPassword = (LPWSTR)((LPBYTE)pdso +
pdso->offsetPassword);
offsetServer
DSDISPLAYSPECOPTIONS 구조체의 시작부터 서버 이름을 포함하는 NULL로 끝나는 유니코드 문자열까지 오프셋(바이트)을 포함합니다. 이 멤버는 dwFlags 에 DSDSOF_HASUSERANDSERVERINFO 플래그가 포함된 경우에만 유효합니다. 이 멤버에 0이 있으면 서버 이름이 포함되지 않습니다.
다음 예제에서는 이 멤버를 사용하는 방법을 보여줍니다.
pwszServer = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServer);
offsetServerConfigPath
DSDISPLAYSPECOPTIONS 구조체의 시작부터 서버의 ADsPath를 포함하는 NULL로 끝나는 유니코드 문자열까지 오프셋(바이트)을 포함합니다. 이 멤버는 dwFlags 에 DSDSOF_HASUSERANDSERVERINFO 플래그가 포함된 경우에만 유효합니다. 이 멤버에 0이 포함된 경우 서버 경로가 포함되지 않습니다.
다음 예제에서는 이 멤버를 사용하는 방법을 보여줍니다.
pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServerConfigPath);
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 머리글 | dsclient.h |