GetRequestedRuntimeVersionForCLSID Function

  • Article

Gets the appropriate common language runtime (CLR) version information for the class with the specified CLSID.

HRESULT GetRequestedRuntimeVersionForCLSID (
    [in]  REFCLSID   rclsid, 
    [out] LPWSTR     pVersion, 
    [in]  DWORD      cchBuffer, 
    [out] DWORD*     dwLength, 
    [in]  CLSID_RESOLUTION_FLAGS dwResolutionFlags
);

Parameters

  • rclsid
    [in] The CLSID of the component.

  • pVersion
    [out] A buffer that contains the version number string upon successful completion.

  • cchBuffer
    [in] The size, in wide characters, of the pVersion buffer.

  • dwLength
    [out] The length, in bytes, of the returned buffer.

  • dwResolutionFlags
    [in] One of the CLSID_RESOLUTION_FLAGS values. The following values are supported:

    • CLSID_RESOLUTION_DEFAULT: (0x0) Specifies that default interop behavior should be used.

    • CLSID_RESOLUTION_REGISTERED: (0x1) Specifies that the registry should be searched and shim policy should be applied.

Return Value

HRESULT

Description

S_OK

The function returned successfully.

E_INVALIDARG

One of the parameters has an invalid type or format.

ERROR_INSUFFICIENT_BUFFER

The pVersion buffer is not large enough to hold the entire version string.

REGDB_E_CLASSNOTREG

There is no class registered with the specified CLSID.

E_POINTER

dwLength is null, or cchBuffer is large enough to hold the version string, but pVersion is null.

Requirements

Platforms: See .NET Framework System Requirements.

Header: MSCorEE.idl

.NET Framework Versions: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1

See Also

Other Resources

Hosting Global Static Functions

Change History

Date

History

Reason

April 2011

Corrected pVersion to [out] and added a missing error condition.

Content bug fix.