|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| ddeml.h
| Unicode
| No
| Platform Notes
| None
|
|
|
DdePostAdvise
The DdePostAdvise function causes the system to send an XTYP_ADVREQ transaction to the calling (server) application's dynamic data exchange (DDE)
callback function for each client with an active advise loop on the specified
topic and item. A server application should call this function whenever the
data associated with the topic name or item name pair changes.
BOOL DdePostAdvise(
DWORD idInst,
| // instance identifier
| HSZ hszTopic,
| // handle to topic name string
| HSZ hszItem
| // handle to item name string
| );
|
|
Parameters
idInst
Specifies the application instance identifier obtained by a previous call to
the DdeInitialize function.
hszTopic
Identifies a string that specifies the topic name. To send notifications for
all topics with active advise loops, an application can set this parameter to
0L.
hszItem
Identifies a string that specifies the item name. To send notifications for
all items with active advise loops, an application can set this parameter to 0L.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Errors
The DdeGetLastError function can be used to get the error code, which may be one of the following
values:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_DLL_USAGE
DMLERR_NO_ERROR
Remarks
A server that has nonenumerable topics or items should set the hszTopic and hszItem parameters to NULL so that the system generates transactions for all active
advise loops. The server's DDE callback function returns NULL for any advise
loops that must not be updated.
If a server calls DdePostAdvise with a topic, item, and format name set that includes the set currently being
handled in an XTYP_ADVREQ callback, a stack overflow may result.
See Also
DdeInitialize, XTYP_ADVREQ
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
