SubscriptionEnumeration.Initialize Method (NSApplication, String, String)

Article
12/03/2008

Initializes an object of the SubscriptionEnumeration class. The set of subscriptions returned is all subscriptions associated with a single subscriber, application, and subscription class.

Namespace: Microsoft.SqlServer.NotificationServices
Assembly: Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

Syntax

'Declaration
Public Sub Initialize ( _
    nsApplication As NSApplication, _
    subscriptionClassName As String, _
    subscriberId As String _
)

public void Initialize (
    NSApplication nsApplication,
    string subscriptionClassName,
    string subscriberId
)

public:
virtual void Initialize (
    NSApplication^ nsApplication, 
    String^ subscriptionClassName, 
    String^ subscriberId
) sealed

public final void Initialize (
    NSApplication nsApplication, 
    String subscriptionClassName, 
    String subscriberId
)

public final function Initialize (
    nsApplication : NSApplication, 
    subscriptionClassName : String, 
    subscriberId : String
)

Parameters

nsApplication
An NSApplication representing the Notification Services application that contains the collection of subscriptions.

subscriptionClassName
A String containing the name of the subscription class.

subscriberId
A String containing the subscriber ID of the subscriber to whom all returned subscriptions must belong.

Remarks

The Initialize method is used in conjunction with the parameterless constructor to enable COM interoperability. It must be called before any other property or method is called on a SubscriptionEnumeration object created with the parameterless constructor.

Example

The following example shows how to create and initialize a SubscriptionEnumeration object in unmanaged Microsoft Visual Basic Scripting Edition (VBScript) code:

Dim myInstance, myApplication, mySubscriptionEnumeration, subscriberId

const instanceName = "MyInstanceName"
const applicationName = "MyApplicationName"
const subscriptionClassName = "MySubscriptionClassName"
subscriberId = "TestSubscriber"

'Create & initialize an NSInstance object.
set myInstance = WScript.CreateObject("Microsoft.SqlServer.NotificationServices.NSInstance")
myInstance.Initialize instanceName

'Create & initialize an NSApplication object.
set myApplication = WScript.CreateObject("Microsoft.SqlServer.NotificationServices.NSApplication")
myApplication.Initialize (myInstance), applicationName

'Create & initialize a SubscriptionEnumeration object.
set mySubscriptionEnumeration = WScript.CreateObject("Microsoft.SqlServer.NotificationServices.SubscriptionEnumeration")
mySubscriptionEnumeration.Initialize (myApplication), subscriptionClassName, subscriberId

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms