Estrutura DSDISPLAYSPECOPTIONS (dsclient.h)
A estrutura DSDISPLAYSPECOPTIONS é retornada pelo formato da área de transferência CFSTR_DS_DISPLAY_SPEC_OPTIONS e é usada para fornecer dados a um menu de contexto ou extensão de página de propriedades sobre os especificadores de exibição usados. É importante especificar as credenciais exigidas pela extensão para acessar dados no servidor do Active Directory.
Sintaxe
typedef struct _DSDISPLAYSPECOPTIONS {
DWORD dwSize;
DWORD dwFlags;
DWORD offsetAttribPrefix;
DWORD offsetUserName;
DWORD offsetPassword;
DWORD offsetServer;
DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;
Membros
dwSize
O tamanho da estrutura para fins de controle de versão.
dwFlags
Um conjunto de sinalizadores que indicam dados sobre o objeto e definem o conteúdo da estrutura. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
DSDSOF_HASUSERANDSERVERINFO (0x00000001)
Os membros offsetUserName, offsetPassword, offsetServer e offsetServerConfigPath são válidos.
DSDSOF_SIMPLEAUTHENTICATE (0x00000002)
Não especifique ADS_SECURE_AUTHENTICATION sinalizador ao chamar ADsOpenObject.
DSDSOF_DONTSIGNSEAL (0x00000004)
Não assinar e selar ao abrir objetos de serviço de diretório.
DSDSOF_DSAVAILABLE (0x40000000)
Força o cliente a evitar verificar se o usuário está autenticado, a rede está presente ou conectada, supondo que o cliente pertença a um domínio controlado por Active Directory Domain Services.
offsetAttribPrefix
Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o prefixo do especificador de exibição do qual a extensão criada foi obtida. Essa cadeia de caracteres pode ser um dos valores a seguir.
"administrador"
A extensão foi obtida do atributo adminPropertyPages .
"shell"
A extensão foi obtida do atributo shellPropertyPages .
O exemplo a seguir mostra como usar esse membro.
pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos +
pdso->offsetAttribPrefix);
offsetUserName
Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o nome do usuário usado para autenticar a associação. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, o nome de usuário não será incluído.
O exemplo a seguir mostra como usar esse membro.
pwszUserName = (LPWSTR)((LPBYTE)pdso +
pdso->offsetUserName);
offsetPassword
Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém a senha usada para autenticar a associação. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, a senha não será incluída.
O exemplo a seguir mostra como usar esse membro.
pwszPassword = (LPWSTR)((LPBYTE)pdso +
pdso->offsetPassword);
offsetServer
Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o nome do servidor. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, o nome do servidor não será incluído.
O exemplo a seguir mostra como usar esse membro.
pwszServer = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServer);
offsetServerConfigPath
Contém o deslocamento, em bytes, desde o início da estrutura DSDISPLAYSPECOPTIONS até uma cadeia de caracteres Unicode terminada em NULL que contém o ADsPath do servidor. Esse membro só será válido se dwFlags contiver o sinalizador DSDSOF_HASUSERANDSERVERINFO . Se esse membro contiver zero, o caminho do servidor não será incluído.
O exemplo a seguir mostra como usar esse membro.
pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServerConfigPath);
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | dsclient.h |