Função DdeCreateDataHandle (ddeml.h)

Artigo
08/23/2023

Cria um objeto DDE (Troca Dinâmica de Dados) e preenche o objeto com dados do buffer especificado. Um aplicativo DDE usa essa função durante transações que envolvem a passagem de dados para o aplicativo parceiro.

Sintaxe

HDDEDATA DdeCreateDataHandle(
  [in]           DWORD  idInst,
  [in, optional] LPBYTE pSrc,
  [in]           DWORD  cb,
  [in]           DWORD  cbOff,
  [in, optional] HSZ    hszItem,
  [in]           UINT   wFmt,
  [in]           UINT   afCmd
);

Parâmetros

[in] idInst

Tipo: DWORD

O identificador de instância do aplicativo obtido por uma chamada anterior para a função DdeInitialize .

[in, optional] pSrc

Tipo: LPBYTE

Os dados a serem copiados para o objeto DDE. Se esse parâmetro for NULL, nenhum dado será copiado para o objeto .

[in] cb

Tipo: DWORD

A quantidade de memória, em bytes, a ser copiada do buffer apontado por pSrc. (inclua o NULL de terminação, se os dados forem uma cadeia de caracteres). Se esse parâmetro for zero, o parâmetro pSrc será ignorado.

[in] cbOff

Tipo: DWORD

Um deslocamento, em bytes, desde o início do buffer apontado pelo parâmetro pSrc . Os dados que começam nesse deslocamento são copiados do buffer para o objeto DDE.

[in, optional] hszItem

Tipo: HSZ

Um identificador para a cadeia de caracteres que especifica o item de dados correspondente ao objeto DDE. Esse identificador deve ter sido criado por uma chamada anterior para a função DdeCreateStringHandle . Se o identificador de dados deve ser usado em uma transação XTYP_EXECUTE , esse parâmetro deve ser 0L.

[in] wFmt

Tipo: UINT

O formato da área de transferência padrão dos dados.

[in] afCmd

Tipo: UINT

Os sinalizadores de criação. Esse parâmetro pode ser HDATA_APPOWNED, que especifica que o aplicativo de servidor que chama a função DdeCreateDataHandle possui o identificador de dados que essa função cria. Esse sinalizador permite que o aplicativo compartilhe o identificador de dados com outros aplicativos DDEML em vez de criar um identificador separado para passar para cada aplicativo. Se esse sinalizador for especificado, o aplicativo deverá eventualmente liberar o objeto de memória compartilhada associado ao identificador usando a função DdeFreeDataHandle . Se esse sinalizador não for especificado, o identificador se tornará inválido no aplicativo que criou o identificador depois que o identificador de dados é retornado pela função de retorno de chamada DDE do aplicativo ou é usado como um parâmetro em outra função DDEML.

Valor retornado

Tipo: HDDEDATA

Se a função for bem-sucedida, o valor retornado será um identificador de dados.

Se a função falhar, o valor retornado será 0L.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

Todos os locais não preenchidos no objeto DDE são indefinidos.

Depois que um identificador de dados tiver sido usado como um parâmetro em outra função DDEML ou tiver sido retornado por uma função de retorno de chamada DDE, o identificador só poderá ser usado para acesso de leitura ao objeto DDE identificado pelo identificador.

Requisitos


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]
Plataforma de Destino	Windows
Cabeçalho	ddeml.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll