RasMonitorDlg

BOOL RasMonitorDlg(
  _In_    LPTSTR          lpszDeviceName,
  _Inout_ LPRASMONITORDLG lpInfo
);

说明

该函数显示用于描述RAS连接状态的拨号网络监视属性页。

参数

lpszDeviceName [in]

指向一个最初显示的设备名称字符串。如果该参数为NULL，或者指定的设备不存在，则显示第一个设备。

lpInfo [in, out]

指向一个RASMONITORDLG结构，用于指定额外的输入输出参数。

调用前将lpInfo->dwSize设置为sizeof(RASMONITORDLG)。

当有错误发生时，可从lpInfo->dwError获取错误代码。

返回值

当用户挂起该连接时，函数返回TRUE，否则返回FALSE。

失败时lpInfo->dwError返回来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。

注意事项

#include <windows.h>
#include <stdio.h>
#include "ras.h"
#include "rasdlg.h"

DWORD __cdecl wmain()
{

    DWORD dwError = ERROR_SUCCESS;
    BOOL nRet = TRUE;

    // Allocate heap memory and initialize RASMONITORDLG structure

    LPRASMONITORDLG lpInfo = (LPRASMONITORDLG) HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(RASMONITORDLG));

    if (lpInfo == NULL)
    {
           printf("HeapAlloc failed");
           return 0;
    }

    // The RASMONITORDLG dwSize member has to be initialized or the RRAS API will fail below.
    lpInfo->dwSize = sizeof(RASMONITORDLG);

    nRet = RasMonitorDlg(NULL,lpInfo);
    dwError = lpInfo->dwError;

    if (nRet == FALSE)
    {
        printf("User hung up the connection.\n");
    }
    else
    {
        if (dwError != ERROR_SUCCESS){
            printf("RasMonitorDlg failed: Error = %d\n", dwError);
        }
        else
        {
            printf("User pressed Close.\n");
        }
    }

    HeapFree(GetProcessHeap(), 0, lpInfo);
    return 0;
}

系统支持

客户端最小支持	Windows 2000 专业版
服务端最小支持	Windows 2000 Server
Header	Rasdlg.h
Library	Rasdlg.lib
DLL	Rasdlg.dll
Unicode和ANSI名称	RasMonitorDlgW(Unicode)和RasMonitorDlgA(ANSI)