Função NDdeGetTrustedShare
[O DDE de rede não tem mais suporte. Nddeapi.dll está presente no Windows Vista, mas todas as chamadas de função retornam NDDE_NOT_IMPLEMENTED.]
Recupera as opções associadas a um compartilhamento DDE que está na lista de compartilhamentos confiáveis do usuário do servidor.
Sintaxe
UINT NDdeGetTrustedShare(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_Out_ LPDWORD lpdwTrustOptions,
_Out_ LPDWORD lpdwShareModId0,
_Out_ LPDWORD lpdwShareModId1
);
Parâmetros
-
lpszServer [in]
-
O nome do servidor no qual o DSDM reside.
-
lpszShareName [in]
-
O nome do compartilhamento cujo status confiável está sendo consultado. Esse parâmetro não pode ser NULL.
-
lpdwTrustOptions [out]
-
Um ponteiro para uma variável que recebe as opções de confiança. Esse parâmetro não pode ser NULL. As opções de confiança a seguir estão disponíveis.
Valor Significado - NDDE_CMD_SHOW_MASK
- 0x0000FFFFL
Máscara usada para obter o valor usado para substituir o estado de exibição de compartilhamento DDE, se NDDE_TRUST_CMD_SHOW estiver definido. - NDDE_TRUST_CMD_SHOW
- 0x10000000L
Substitua o estado de exibição especificado no DSDM de compartilhamento DDE. - NDDE_TRUST_SHARE_DEL
- 0x20000000L
Remova a status confiável do compartilhamento. - NDDE_TRUST_SHARE_INIT
- 0x40000000L
Permitir que um cliente inicie o aplicativo se ele já estiver em execução no contexto do usuário. - NDDE_TRUST_SHARE_START
- 0x80000000L
Permitir que o aplicativo seja iniciado no contexto do usuário. -
lpdwShareModId0 [out]
-
Um ponteiro para uma variável que recebe a primeira parte do identificador de modificação de compartilhamento confiável. Esse parâmetro não pode ser NULL.
-
lpdwShareModId1 [out]
-
Um ponteiro para uma variável que recebe a segunda parte do identificador de modificação de compartilhamento confiável. Esse parâmetro não pode ser NULL.
Valor retornado
Se a função for bem-sucedida, o valor retornado será NDDE_NO_ERROR.
Se a função falhar, o valor retornado será um código de erro, que pode ser convertido em uma mensagem de erro de texto chamando NDdeGetErrorString.
Comentários
O identificador de modificação de compartilhamento confiável reflete a versão do compartilhamento DDE no DSDM no momento em que o compartilhamento DDE foi inicialmente concedido status confiáveis. O identificador de modificação de compartilhamento confiável é usado principalmente para remover compartilhamentos confiáveis obsoletos. No entanto, o usuário não precisa remover compartilhamentos confiáveis obsoletos. O agente DDE de rede remove compartilhamentos obsoletos em nome do usuário.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|
| Nomes Unicode e ANSI |
NDdeGetTrustedShareW (Unicode) e NDdeGetTrustedShareA (ANSI) |