Funzione DdePostAdvise (ddeml.h)

Fa in modo che il sistema invii una transazione XTYP_ADVREQ alla funzione di callback dell'applicazione Dynamic Data Exchange (DDE) dell'applicazione chiamante per ogni client con un ciclo di consigli attivo sull'argomento e sull'elemento specificati. Un'applicazione server deve chiamare questa funzione ogni volta che i dati associati al nome dell'argomento o alla coppia nome elemento cambia.

Sintassi

BOOL DdePostAdvise(
  [in] DWORD idInst,
  [in] HSZ   hszTopic,
  [in] HSZ   hszItem
);

Parametri

[in] idInst

Tipo: DWORD

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

[in] hszTopic

Tipo: HSZ

Handle di una stringa che specifica il nome dell'argomento. Per inviare notifiche per tutti gli argomenti con cicli di avviso attivi, un'applicazione può impostare questo parametro su 0L.

[in] hszItem

Tipo: HSZ

Handle di una stringa che specifica il nome dell'elemento. Per inviare notifiche per tutti gli elementi con cicli di avviso attivi, un'applicazione può impostare questo parametro su 0L.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

La funzione DdeGetLastError può essere usata per ottenere il codice di errore, che può essere uno dei valori seguenti:

Commenti

Un server con argomenti o elementi non numerabili deve impostare i parametri hszTopic e hszItem su NULL in modo che il sistema generi transazioni per tutti i cicli di avviso attivi. La funzione di callback DDE del server restituisce NULL per tutti i cicli consigliati che non devono essere aggiornati.

Se un server chiama DdePostAdvise con un argomento, un elemento e un set di nomi di formato che include il set attualmente gestito in un callback XTYP_ADVREQ , un overflow dello stack può risultare.

Requisiti

Vedi anche

Informazioni concettuali

DdeInitialize

Libreria di gestione di Dynamic Data Exchange

Riferimento

XTYP_ADVREQ