Estrutura NDDESHAREINFO
[Não há mais suporte para DDE de rede. Nddeapi.dll está presente no Windows Vista, mas todas as chamadas de função retornam NDDE_NOT_IMPLEMENTED.]
Contém atributos de compartilhamento DDE mantidos pelo DSDM (Gerenciador de Banco de Dados de Compartilhamento) do NetDDE. O descritor de segurança associado a cada compartilhamento DDE não é passado por essa estrutura, mas é acessado por meio de funções específicas. A API DSDM do NetDDE aceita essa estrutura para funções definidas; para obter funções, o DSDM retorna a estrutura empacotada no buffer fornecido junto com os dados referenciados pelos membros lpszShareName, lpszAppTopicList e lpszItemList.
Sintaxe
typedef struct _NDDESHAREINFO {
LONG lRevision;
LPTSTR lpszShareName;
LONG lShareType;
LPTSTR lpszAppTopicList;
LONG fSharedFlag;
LONG fService;
LONG fStartAppFlag;
LONG nCmdShow;
LONG qModifyId[2];
LONG cNumItems;
LPTSTR lpszItemList;
} NDDESHAREINFO, *PNDDESHAREINFO;
Membros
-
lRevision
-
O nível de revisão da estrutura NDDESHAREINFO . Atualmente, o nível de revisão é 1.
-
lpszShareName
-
O nome do compartilhamento. Essa cadeia de caracteres não deve ter mais de MAX_NDDESHARENAME caracteres.
-
lShareType
-
Um ou mais tipos de compartilhamento DDE. Esse membro pode ser uma combinação dos seguintes tipos de compartilhamento DDE com suporte.
Tipo de compartilhamento Significado - SHARE_TYPE_NEW
- 0x02
O compartilhamento contém um par de aplicativos/tópicos OLE. - SHARE_TYPE_OLD
- 0x01
O compartilhamento contém um par de aplicativos/tópicos DDE. - SHARE_TYPE_STATIC
- 0x04
O compartilhamento contém um par de aplicativos/tópicos estáticos. -
lpszAppTopicList
-
Um ponteiro para um buffer que contém cadeias de caracteres terminadas em nulo para os pares DDE, OLE e aplicativo/tópico estático. O buffer deve estar no seguinte formato:
<DDE application name>|<DDE topic name>\0 <OLE application name>|<OLE topic name>\0 <static application name>|<static topic name>\0\0 -
fSharedFlag
-
Se esse membro for FALSE, o compartilhamento DDE não permitirá que usuários remotos se comuniquem por meio dele usando o DDE. No entanto, os usuários locais ainda podem se comunicar por meio do compartilhamento DDE. Os links de cliente locais serão sempre implícitos se a DACL associada conceder acesso.
-
fService
-
Se esse membro estiver definido, o compartilhamento DDE não marcar se o usuário atual o definiu como confiável antes de permitir a comunicação DDE.
-
fStartAppFlag
-
Se esse membro estiver definido e o compartilhamento for confiável para iniciar aplicativos, o NetDDE tentará iniciar o aplicativo especificado por lpszAppTopicList se ele não puder iniciar inicialmente uma conversa DDE com o aplicativo.
-
nCmdShow
-
Quando o NetDDE inicia um aplicativo para iniciar uma conversa DDE, esse valor é enviado ao aplicativo por meio do parâmetro nCmdShow da função WinMain . Ele define o modo preferencial para a janela do aplicativo a ser mostrada. Esse parâmetro só será significativo se fStartAppFlag estiver ativo. O usuário conectado em cujo contexto o aplicativo é iniciado também pode substituir essa opção ao promover o compartilhamento para status confiáveis. O padrão para esse membro é SW_SHOWMAXIMIZED.
-
qModifyId
-
Um número de série de 8 bytes que indica o número de série de modificação do compartilhamento DDE. Sempre que o compartilhamento DDE é modificado por uma chamada NDdeShareSetInfo ou NDdeSetShareSecurity , esses valores são alterados.
-
cNumItems
-
O número de itens listados em lpszItemList. Se cNumItems for zero, lpszItemList estará vazio e as informações de compartilhamento e o descritor de segurança associado se aplicarão a todos os itens atendidos pelo aplicativo associado.
-
lpszItemList
-
Um ponteiro para um buffer que contém cadeias de caracteres terminadas em nulo que especificam os itens em que o aplicativo cliente em uma transação DDE pode solicitar ou iniciar loops de consultoria. Se nenhum item estiver listado, o compartilhamento DDE permitirá que qualquer item seja usado. O número de itens na lista deve corresponder à contagem de cNumItems .
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 |
|