IProfferService.RevokeService Method

Article
04/22/2008

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

'Déclaration
Function RevokeService ( _
    dwCookie As UInteger _
) As Integer
'Utilisation
Dim instance As IProfferService
Dim dwCookie As UInteger
Dim returnValue As Integer

returnValue = instance.RevokeService(dwCookie)

int RevokeService(
    uint dwCookie
)

int RevokeService(
    [InAttribute] unsigned int dwCookie
)

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.

Permissions

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.

Partager via