GetProp和SetProp的用法

                                         

                                 GetProp和SetProp的用法

转自：http://blog.csdn.net/primer_programer/archive/2008/01/18/2050750.aspx

 

在百度百科中对GetProp和SetProp的解释如下：GetProp
函数功能：该函数从给定窗口的属性列表中检索数据句柄。给定的字符串标识了要检索的句柄。该字符串和句柄必须在前一次调用SetProp函数时已经加到属性表中。

    函数原型：HANDLE GetProp（HWND hWnd，LPCTSTR lpString）；

    参数：

    hWnd：指向要搜索属性表的窗口。

    LpString：指向以null结尾的字符串指针，或者包含一个标识字符串的原子。如果该参数是一个原子，那么它必须是使用GlobalAddAtom函数创建的。原子是16位的数据值，它必须是放置在lpstring参数的低位率中，而高位字必须为O。

    返回值：如果属性表中包含了给定的字符串，那么返回值为相关的数据句柄。否则，返回值为NULL。

SetProp
函数功能：该函数在指定窗口的属性表中增加一个新项，或者修改一个现有项。如果指定的字符串不在属性表中，那么就增加该新的项，新项中包含该字符串和句柄，否则就用指定的句柄替换该字符串的全前句柄。

    函数原型：BOOL SetProp（HWND hWnd，LPCTSTR lpString，HANDLE hData）；

    参数：

    hWnd：指向窗口的句柄，该窗口的属性表要接收一个新项。

    lpString：指向以null结尾的字符串指针，或者包含一个标识字符串的原子。如果该参数是一个原子，么它必须是以前使用GlobalAddAtom函数创建的。原子是16位的数据值，它必须是放置在lpstring参数低位字中，而高位字必须为O。

    hData：指向要拷贝到属性表中的数据的句柄。该数据句柄可以标识任何对应用程序有用的值。

    返回值：如果该数据句柄和字符串以加到属性表中，那么返回值为非零。如果该函数失败，那么返回为零。若想获得更多错误信息，请调用GetLastError函数。

    备注：在清除窗口之前（也就足在处理WM_DESTROY消息之前），应用程序必须把它加到属性表的所项清除。应用程序必须使用RemoveProp函数来清除这些项。
可以使用GetProp和SetProp函数来查找已经启动的程序的窗口。使用SetProp向窗口的属性表中添加字符串。可以在对话框的OnInitDialog函数的最后添加下面语句。::SetProp( this->m_hWnd, "字符串", (HANDLE)1 );使用GetProp在窗口的属性表中查找字符串。::GetProp(hwnd, "字符串") BOOL CAutoRunApp::ensureOneInstance()

{ m_hMutex = CreateMutex( NULL, FALSE, _T( "AutoRun" ) ); if ( m_hMutex ) {  if ( GetLastError() == 183 /*ERROR_ALREADY_EXISTS*/ )  {   CloseHandle( m_hMutex );   HWND hWndPrevious = ::GetWindow( ::GetDesktopWindow(), GW_CHILD );   while(::IsWindow(hWndPrevious))   {    if (::GetProp(hWndPrevious, EXEPROP))    {     if (::IsIconic(hWndPrevious))     {      ::ShowWindow(hWndPrevious, SW_RESTORE);      ::SetForegroundWindow(hWndPrevious);     }     else     {      ::SetForegroundWindow(::GetLastActivePopup(hWndPrevious));     }     return FALSE;    }    hWndPrevious = ::GetWindow( hWndPrevious, GW_HWNDNEXT );   }   return FALSE;  } } return TRUE;}