Ler em inglês

Compartilhar via


Método Application.GetGroupApplicationGroup

Obtém uma conta Microsoft Windows NT Domain\Group associado com um definição de aplicativo corporação GRUPO.

Espaço para nome Microsoft.SharePoint.Portal.SingleSignon
Conjunto de Módulos (Assembly) Microsoft.SharePoint.Portal.SingleSignon (em microsoft.sharepoint.portal.singlesignon.dll)

A sintaxe

<SingleSignonPermissionAttribute(SecurityAction.Demand, Access:=SingleSignonAccess.Minimal)> _
Public Shared Sub GetGroupApplicationGroup ( _
    strApplicationName As String, _
    ByRef strGroupName As String _
)

Dim strApplicationName As String
Dim strGroupName As String

Application.GetGroupApplicationGroup(strApplicationName, strGroupName)
[SingleSignonPermissionAttribute(SecurityAction.Demand, Access=SingleSignonAccess.Minimal)] 
public static void GetGroupApplicationGroup (
    string strApplicationName,
    ref string strGroupName
)

Parâmetros

  • strApplicationName
    O nome do definição de aplicativo a corporação associado com este nome conta NT Domain\Group Domain\Group.Isso não é a nome amigável definição de aplicativo corporação.O número máximo de caracteres permitidos é 128.
  • strGroupName
    O nome GRUPO de SSO.

Comentários

Serviço Microsoft Single Sign-On (SSOSrv) tem dois tipos corporação definição de aplicativo: GRUPO aplicativo e individual aplicativo.Use o GetGroupApplicationGroup GetGroupApplicationGroup método para o tipo aplicativo GRUPO.Se o nome especificado definição de aplicativo não é um aplicativo GRUPO, será retornado um erro de aplicativo não encontrado.Se o nome especificado definição de aplicativo é um aplicativo GRUPO, mas as credenciais não forem definidas, NULL é retornado.

Somente um membro de GRUPO única administração sign-on ou Gerenciador um aplicativo pode usar o GetGroupApplicationGroup método GetGroupApplicationGroup.

O resultado da cada chamar para o GetGroupApplicationGroup GetGroupApplicationGroup método é auditado e armazenado em banco de dados de sign-on único.A enumeração ServiceAction ServiceAction registrada é GetApplication.

Exemplo

O seguinte mostra como usar o GetGroupApplicationGroup método GetGroupApplicationGroup exemplo de código.Para usar esse exemplo, substituir domain_name\\group_name com um válido domínio e GRUPO em sua rede.

using System;
using Microsoft.SharePoint.Portal.SingleSignon;

namespace SSOSampleCode
{
/// <summary>
/// Sample code for SharePoint Portal Single SignOn.
/// </summary>
class CMainEntry
{
            [STAThread]
            static void Main(string[] args)
            {
                try
                {
                    //Create the application fields (max 5 fields).
                    Application.ApplicationField[] rgFields = new Application.ApplicationField[5];

                    rgFields[0] = new Application.ApplicationField(
                        "Field1 Label",  //Application field name
                        true);           //true == mask in the UI, false == don't mask in the UI

                    rgFields[1] = new Application.ApplicationField(
                        "Field2 Label",
                        false);

                    rgFields[2] = new Application.ApplicationField(
                        "Field3 Label",
                        true);

                    rgFields[3] = new Application.ApplicationField(
                        "Field4 Label",
                        false);

                    rgFields[4] = new Application.ApplicationField(
                        "Field5 Label",
                        true);

                    //Create group application information data.
                    Application.ApplicationInfo App = new Application.ApplicationInfo(
                        "MyGroupApplicationID",
                        "My Group Applicaiton Display Name",
                        Application.ApplicationType.Group,
                        "someone@someplace.someext");
                    //Now, add the application
                    Application.AddApplication(
                        App,
                        rgFields,
                        Application.ApplicationCreationDisposition.CreateNew);

                    Console.WriteLine("Successfully added the group application!");

                    //Next, add credentials for this group application.
                    string[] rgCredentialsData = new string[5];

                    rgCredentialsData[0] = "Data for field1";
                    rgCredentialsData[1] = "Data for field2";
                    rgCredentialsData[2] = "Data for field3";
                    rgCredentialsData[3] = "Data for field4";
                    rgCredentialsData[4] = "Data for field5";

                    Credentials.SetGroupCredentials(
                        "MyGroupApplicationID",
                        "domain_name\\group_name",
                        rgCredentialsData);
                    Console.WriteLine("Successfully added credentials to the group application");

                    //Get the group applications associated group account name.
                    string strGroupName = null;
                    Application.GetGroupApplicationGroup(
                        "MyGroupApplicationID",
                        ref strGroupName);

                    Console.WriteLine("Group account associated with this application is: " + strGroupName);
                }
                catch (SingleSignonException esso)
                {
                    Console.WriteLine("SingleSignonException caught.");
                    Console.WriteLine("Exception Code: " + "0x" + esso.LastErrorCode.ToString("x"));
                    Console.WriteLine("Source: " + esso.Source);
                    Console.WriteLine("StackTrace: " + esso.StackTrace);
                    Console.WriteLine("MethodName: " + esso.TargetSite.Name);
                    Console.WriteLine("Message: " + esso.Message);
                }
                catch (Exception e)
                {
                    Console.WriteLine("Exception caught.");
                    Console.WriteLine("Source: " + e.Source);
                    Console.WriteLine("StackTrace: " + e.StackTrace);
                    Console.WriteLine("MethodName: " + e.TargetSite.Name);
                    Console.WriteLine("Message: " + e.Message);
                }
            }
    }
}

Consulte também

Referência

Application De classe
Application Membros
Microsoft.SharePoint.Portal.SingleSignon De espaço para nome