IProfferService.RevokeService Method

Article
02/04/2013

Prevents third-party clients from accessing a specified service.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
Function RevokeService ( _
    dwCookie As UInteger _
) As Integer

int RevokeService(
    uint dwCookie
)

int RevokeService(
    [InAttribute] unsigned int dwCookie
)

abstract RevokeService : 
        dwCookie:uint32 -> int

function RevokeService(
    dwCookie : uint
) : int

Parameters

dwCookie
Type: System.UInt32
[in] Identifier of the specified service that is returned by a call to ProfferService.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From proffserv.idl:

HRESULT IProfferService::RevokeService(
   [in] DWORD dwCookie
);

This method is rarely used. Normally, once a VSPackage proffers its services, they remain available until Visual Studio is shut down. That is, the environment handles revoking services automatically.

If a service is not currently provided at the time an attempt is made to revoke it, the RevokeService method will fail and return S_FALSE.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.