Module: wine
Branch: master
Commit: 07229ed8ec07cf6a5353e5ff6eab1129a4410d72
URL: http://source.winehq.org/git/wine.git/?a=commit;h=07229ed8ec07cf6a5353e5ff6…
Author: Rob Shearman <rob(a)codeweavers.com>
Date: Tue May 8 00:02:06 2007 +0100
ole32: Add documentation for error info functions.
---
dlls/ole32/errorinfo.c | 35 +++++++++++++++++++++++++++++++++++
1 files changed, 35 insertions(+), 0 deletions(-)
diff --git a/dlls/ole32/errorinfo.c b/dlls/ole32/errorinfo.c
index 01dc305..7318a97 100644
--- a/dlls/ole32/errorinfo.c
+++ b/dlls/ole32/errorinfo.c
@@ -465,8 +465,18 @@ static const ISupportErrorInfoVtbl ISupportErrorInfoImpl_VTable =
ISupportErrorInfoImpl_InterfaceSupportsErrorInfo
};
+
/***********************************************************************
* CreateErrorInfo (OLE32.@)
+ *
+ * Creates an object used to set details for an error info object.
+ *
+ * PARAMS
+ * pperrinfo [O]. Address where error info creation object will be stored.
+ *
+ * RETURNS
+ * Success: S_OK.
+ * Failure: HRESULT code.
*/
HRESULT WINAPI CreateErrorInfo(ICreateErrorInfo **pperrinfo)
{
@@ -483,6 +493,21 @@ HRESULT WINAPI CreateErrorInfo(ICreateErrorInfo **pperrinfo)
/***********************************************************************
* GetErrorInfo (OLE32.@)
+ *
+ * Retrieves the error information object for the current thread.
+ *
+ * PARAMS
+ * dwReserved [I]. Reserved. Must be zero.
+ * pperrinfo [O]. Address where error information object will be stored on return.
+ *
+ * RETURNS
+ * Success: S_OK if an error information object was set for the current thread.
+ * S_FALSE if otherwise.
+ * Failure: E_INVALIDARG if dwReserved is not zero.
+ *
+ * NOTES
+ * This function causes the current error info object for the thread to be
+ * cleared if one was set beforehand.
*/
HRESULT WINAPI GetErrorInfo(ULONG dwReserved, IErrorInfo **pperrinfo)
{
@@ -511,6 +536,16 @@ HRESULT WINAPI GetErrorInfo(ULONG dwReserved, IErrorInfo **pperrinfo)
/***********************************************************************
* SetErrorInfo (OLE32.@)
+ *
+ * Sets the error information object for the current thread.
+ *
+ * PARAMS
+ * dwReserved [I] Reserved. Must be zero.
+ * perrinfo [I] Error info object.
+ *
+ * RETURNS
+ * Success: S_OK.
+ * Failure: E_INVALIDARG if dwReserved is not zero.
*/
HRESULT WINAPI SetErrorInfo(ULONG dwReserved, IErrorInfo *perrinfo)
{
Module: wine
Branch: master
Commit: 314f9fe509f7f96fc2bd9cc38382a50602225409
URL: http://source.winehq.org/git/wine.git/?a=commit;h=314f9fe509f7f96fc2bd9cc38…
Author: Rob Shearman <rob(a)codeweavers.com>
Date: Tue May 8 00:01:19 2007 +0100
ole32: Add documentation about registered class objects only being visible in the apartment in which they were registered.
---
dlls/ole32/compobj.c | 9 +++++++++
1 files changed, 9 insertions(+), 0 deletions(-)
diff --git a/dlls/ole32/compobj.c b/dlls/ole32/compobj.c
index 5ba74d7..7eef76e 100644
--- a/dlls/ole32/compobj.c
+++ b/dlls/ole32/compobj.c
@@ -1646,6 +1646,11 @@ static HRESULT COM_GetRegisteredClassObject(
* SEE ALSO
* CoRevokeClassObject, CoGetClassObject
*
+ * NOTES
+ * In-process objects are only registered for the current apartment.
+ * CoGetClassObject() and CoCreateInstance() will not return objects registered
+ * in other apartments.
+ *
* BUGS
* MSDN claims that multiple interface registrations are legal, but we
* can't do that with our current implementation.
@@ -1801,6 +1806,10 @@ static void COM_RevokeAllClasses(struct apartment *apt)
* Success: S_OK.
* Failure: HRESULT code.
*
+ * NOTES
+ * Must be called from the same apartment that called CoRegisterClassObject(),
+ * otherwise it will fail with RPC_E_WRONG_THREAD.
+ *
* SEE ALSO
* CoRegisterClassObject
*/