Função NDdeTrustedShareEnum

Artigo
06/12/2023

[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 os nomes de todos os compartilhamentos de DDE de rede confiáveis no contexto do processo de chamada.

Sintaxe

UINT NDdeTrustedShareEnum(
  _In_  LPTSTR  lpszServer,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnEntriesRead,
  _Out_ LPDWORD lpcbTotalAvailable
);

Parâmetros

lpszServer [in]: O nome do servidor no qual o DSDM reside.
nLevel [in]: Reservado. Esse parâmetro deve ser zero.
lpBuffer [out]: Um ponteiro para um buffer que recebe a lista de compartilhamentos DDE confiáveis. A lista de compartilhamentos DDE confiáveis é retornada como uma sequência de cadeias de caracteres separadas por nulo que terminam com um caractere nulo duplo no final. Este parâmetro pode ser NULL. Se o lpBuffer for NULL, o DSDM retornará o tamanho do buffer necessário para manter a lista de compartilhamentos no campo lpcbTotalAvailable .
cBufSize [in]: O tamanho do buffer lpBuffer , em bytes. Esse parâmetro deverá ser zero se lpBuffer for NULL.
lpnEntriesRead [out]: Um ponteiro para uma variável que recebe o número total de compartilhamentos confiáveis sendo enumerados. Esse parâmetro não pode ser NULL.
lpcbTotalAvailable [out]: Um ponteiro para uma variável que recebe o número total de bytes necessários para armazenar a lista de compartilhamentos DDE confiáveis. 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. Se o parâmetro lpBuffer for NULL, ele retornará NDDE_BUF_TOO_SMALL.

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	Nddeapi.h
Biblioteca	Nddeapi.lib
DLL	Nddeapi.dll
Nomes Unicode e ANSI	NDdeTrustedShareEnumW (Unicode) e NDdeTrustedShareEnumA (ANSI)

Confira também

Visão geral do Exchange de Dados Dinâmicos de Rede
Funções DDE de rede

Compartilhar via