Funzione DdeQueryStringA (ddeml.h)

Articolo
02/26/2024

Copia il testo associato a un handle di stringa in un buffer.

Sintassi

DWORD DdeQueryStringA(
  [in]            DWORD idInst,
  [in]            HSZ   hsz,
  [out, optional] LPSTR psz,
  [in]            DWORD cchMax,
  [in]            int   iCodePage
);

Parametri

[in] idInst

Tipo: DWORD

Identificatore dell'istanza dell'applicazione ottenuto da una chiamata precedente alla funzione DdeInitialize .

[in] hsz

Tipo: HSZ

Handle della stringa da copiare. Questo handle deve essere stato creato da una chiamata precedente alla funzione DdeCreateStringHandle .

[out, optional] psz

Tipo: LPTSTR

Puntatore a un buffer che riceve la stringa. Per ottenere la lunghezza della stringa, questo parametro deve essere impostato su NULL.

[in] cchMax

Tipo: DWORD

Lunghezza, in caratteri, del buffer a cui punta il parametro psz . Per la versione ANSI della funzione, si tratta del numero di byte; per la versione Unicode, si tratta del numero di caratteri. Se la stringa è più lunga di ( cchMax- 1), verrà troncata. Se il parametro psz è impostato su NULL, questo parametro viene ignorato.

[in] iCodePage

Tipo: int

Tabella codici utilizzata per eseguire il rendering della stringa. Questo valore deve essere CP_WINANSI o CP_WINUNICODE.

Valore restituito

Tipo: DWORD

Se il parametro psz ha specificato un puntatore valido, il valore restituito è la lunghezza, espressa in caratteri, del testo restituito (non incluso il carattere null di terminazione). Se il parametro psz ha specificato un puntatore NULL , il valore restituito è la lunghezza del testo associato al parametro hsz (non incluso il carattere Null di terminazione). Se si verifica un errore, il valore restituito è 0L.

Commenti

La stringa restituita nel buffer è sempre con terminazione Null. Se la stringa è più lunga di ( cchMax- 1), vengono copiati solo i primi caratteri ( cchMax- 1) della stringa.

Se il parametro psz è NULL, la funzione DdeQueryString ottiene la lunghezza, espressa in byte, della stringa associata all'handle di stringa. La lunghezza non include il carattere Null di terminazione.

Nota

L'intestazione ddeml.h definisce DdeQueryString come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ddeml.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll