大网数据广告活动
网络与域名解析

Server Context Run-down Routine

· 52CE 我爱测

If communication breaks down while the server is maintaining context on behalf of the client, a cleanup routine may be needed to clean up the state maintained by the server on behalf of a given client.

If communication breaks down while the server is maintaining context on behalf of the client, a cleanup routine may be needed to clean up the state maintained by the server on behalf of a given client. This cleanup routine is called a context run-down routine. When a connection breaks, the server stub and the run-time library will call this routine on every context handle opened by the client.

The context run-down routine is required, and is implicitly declared and named, when you apply the [context_handle] attribute to a type definition. The server will not call the context run-down routine if the [context_handle] attribute was applied directly to a parameter.

The context run-down routine syntax is:

void __RPC_USER type-id_rundown (type-id);

Note that the type name determines the name of the context run-down routine.

The code fragment that follows presents a sample context run-down routine. that calls the RemoteClose procedure used in the example in Interface Development Using Context Handles, Server Development Using Context Handles, and Client Development Using Context Handles. This procedure closes the file handle, frees the memory associated with the file, and assigns NULL to the context handle. Assigning NULL is a result of calling the RemoteClose function, and is not necessary in a run-down scenario. The RPC run time cleans up its state regardless of whether the context handle is set to NULL.

//file: cxhndp.c (fragment of file containing remote procedures)
//The rundown routine is associated with the context handle type.  
void __RPC_USER PCONTEXT_HANDLE_TYPE_rundown(
    PCONTEXT_HANDLE_TYPE phContext)
{
    printf("Client died with an open file, closing it..\n");
    RemoteClose(&phContext);
    assert(phContext == 0);
}

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。