CRegKey::QueryGUIDValue

Call this method to retrieve the GUID data for a specified value name.

LONG QueryGUIDValue( 
   LPCTSTR pszValueName, 
   GUID& guidValue  
) throw( );

Parameters

  • pszValueName
    Pointer to a null-terminated string containing the name of the value to query.

  • guidValue
    Pointer to a variable that receives the GUID.

Return Value

If the method succeeds, ERROR_SUCCESS is returned. If the method fails to read a value, it returns a nonzero error code defined in WINERROR.H. If the data referenced is not a valid GUID, ERROR_INVALID_DATA is returned.

Remarks

This method makes use of CRegKey::QueryStringValue and converts the string into a GUID using CLSIDFromString.

Security noteSecurity Note

This method allows the caller to specify any registry location, potentially reading data which cannot be trusted.

Requirements

Header: atlbase.h

See Also

Reference

CRegKey Class

CRegKey::SetGUIDValue

CRegKey::QueryBinaryValue

CRegKey::QueryDWORDValue

CRegKey::QueryMultiStringValue

CRegKey::QueryQWORDValue

CRegKey::QueryStringValue