Funzione DdeQueryStringA (ddeml.h)

Articolo
11/20/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, questo è il 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 psz parametro ha specificato un puntatore valido, il valore restituito è la lunghezza, in caratteri, del testo restituito (senza includere il carattere Null di terminazione). Se il parametro psz ha specificato un puntatore NULL , il valore restituito corrisponde alla lunghezza del testo associato al parametro hsz (senza includere il carattere Null di terminazione). Se si verifica un errore, il valore restituito è 0L.

Osservazioni

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

Se il parametro psz è NULL, la funzione DdeQueryString ottiene la lunghezza, 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ddeml.h (include Windows.h)
libreria	User32.lib
dll	User32.dll